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This publicatioa describes the LEVELQ Extended Machine, a 
component of the Brown Operating Graphics University System, 
running on the BUGS META 4A processor. LEVEIO provides the BUGS 
user with facilities beyond those inherent in the 
hardware/firmware. A thorough knowledge of the Principles of 
Operation of the META 4A is assumed. 




1 INTRODUCTION 


LEVELO is a software package designed to run on the META 4A and 
provide the BUGS user with facilities making up an extended 
machine. These facilities alleviate some of the drudgery of 
coding on a bare machine and assume responsibility for many 
machine functions, freeing the user to worry about the operation 
of BUGS (referred to as the ’•system") at a higher level. LEVELO 
assumes the presence of another level of operating system, 
running as a "LEVEL 1" above it. Such a LEVEL 1 does exist on 
BUGS, and is called the Graphics Monitor System (GMS), or, to 
close friends, "Cur Fearless Leader". In this publication, 
however, it will be referred to as LEVEL) for generality. 

The reader is assumed to have a thorough knowledge of the META 4A 
and BUGS in general. In particular, however, he will use only 
those "normal" instructions not concerned with machine status, 
interrupt handling, I/O, etc. LEVELO is responsible for handling 
those portions of the machine. Thus it is necessary for the 
reader to realize that much of what he reads in the META 4A 
Principles of Operation will not directly concern him. 
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2 THE LEVEL 1 ROUTINE AMD ITS STACK FRAME 


2.1 LEVEL 1 VS. THE BARE MACHINE 


A LEVEL1 routine running on LEVELO must follow somewhat 
different conventions from one running stand-alone on the META 
4A. These conventions are necessary for two reasons. First 
of all, they allow LEVELO to maintain control over the status 
of the system, and secondly, they provide a higher level of 
system organization for the LEVEL! programmer. 


2.1.1 NON-PRIVILEGED STATE 


The LEVEL1 routine runs at all times with the Privilege bit 
in the MSR off. This prevents him from performing local I/O 
and S/360 operations without using the facilities provided 
by LEVELO. Specifically, he cannot execute the following 
instructions: SIOR, S 10, RST, WST, EXCC, TR3, and SS. It 
is considered invalid for the LEVEL 1 system ever to set the 
Privilege bit on. 


2.1.2 WAIT STATE 


In addition to the Privilege bit, the IEVEL1 program must 
never set the Wait bit in the MSR. LEVELO assumes all 
control of the state of the system, including the setting 
of this bit. 


2.1.3 EXTENDED INSTRUCTIONS 


Because of the above restrictions and for the increased 
flexibility of LEVEL1, LEVELO provides a set of "Extended 
Machine Instructions". These instructions, which are coded 
by the programmer as if they were real META 4A 
instructions, provided added features for LEVEL 1, such as 
memory managemen t, extended I/O, etc. These instructions, of 
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which there are some fifteen, will be explained in the 
course of this publication. 


2.2 THE PROGRAMMER' S DATA 


Since computing is concerned with the manipulation of data, 
strict conventions concerning types of data are made by 
LEVELO. There are specifically three types of data with which 
the programmer can concern himself: static, automatic, and 
controlled. 


2.2.1 STATIC DATA 


Static data is data that is assembled/compiled into a 
routine and is present there when the routine is loaded. 
This data includes the instructions of the program itself, 
plus any pre-initialized variables DCed within the routine 
proper. The term "static" may be misleading in that it is 
not assumed that static data will remain unchanged 
throughout the execution of a program; it is certainly 
possible for a programmer to DC an initial value for a 
variable and then change it later. The term static simply 
implies that the data was defined before execution of the 
routine was begun. 


2.2.2 AUTOMATIC DATA 


Automatic data is the term applied to variable space which 
is allocated prior to the execution of a routine and freed 
when that routine completes. This data cannot be 
initialized at assenbly/compile time, because the storage 
does not exist at this point. The data is local to the 
routine owning the automatic storage and disappears when 
that routine completes. It is this type of data that is 
specially treated by LEVELO. 
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2.2.3 CONTROLLED DATA 


Controlled data is data which is maintained in storage 
space obtained by a routine and present until exclicitly 
released. Extended instructions are provided to maintain 
this controlled storage. Most programmers are probably 
familiar with this type of storage from experience with ISM 
Operating Systera/360 or similar systems, with their GETMA1N 
and FREEMAIN SVCs. 


2.3 THE STACK FRAME 


As was mentioned above, automatic storage is one special 
feature of LEVELO. In order to maintain this automatic 
storage across normal occurences such as subroutine calling 
and the execution of interrupt handlers and the like, LEVELO 
maintains a number of "stack frames" in the META 4A. A stack 
frame is a logically infinite piece of storage in which is 
maintained a series of automatic storage sections for each 
routine in the dynamic sequence of execution. Each routine 
need only be concerned with the section of the stacic frame 
belonging to him. This section has the following format: 


SFP 

I 

V 

0 |previous pointer! 

i-g 

2 | next pointer | 

p-q 

4 I I 

save area 
I I 

t -g 

221 | 

antoma tic 
storage 

I I 


previous pointer: this halfword contains the address of the 

stack frame section of the routine executing dynamically 
prior to this routine. 
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next pointer: this pointer is used by LEVEL0 to maintain the 
dynamic link of stack frame sections and is of no direct 
use to the programmer. ( \j£*i Vy 

save area: these 15 halfwords are used to store the routine's 
MSR through register 14 at any time his execution is 
delayed due to an actual machine interrupt or to a 
subroutine call. 

1/1 ^ wj < 

automatic storage: This space is the actual automatic storage 
requested by the routine. It can vary in size from 1 to 
n halfwords; this size is determined by the extended 
instruction ENT, which must be the fi rst instruction of 
every routine that either saves the registers of the 
previous routine or requires automatic storage or both. 


2.4 SUBROUTINE LINKAGE INSTRUCTIONS 


ENTer routine ENT RI 

The immediate halfword of this Rl-format extended instruction 
specifies the size, in bytes, of the automatic storage 
required by the routine. The size is rounded up to the next 
higher halfword, if necessary, and used to determine the size 
of the automatic storage shown in the diagram above. This 
instruction must be the first executed instruction of every 
routine in which it appears. 


Once the ENT 
0 through 14 
Frame Pointer 
frame section 
used as a 
stack frame, 
routine. Its 


instruction is performed, the caller's 
are saved in the caller's savearea, and 
(SFP) , register 15, is set 
for the ENTered routine. 


registers 
the Stack 
to point at the stack 
This register may be 


base for instructions accessing data out of the 
but should not be modified in any way by the 
contents are maintained entirely by LEVELO. 


Once a routine has completed execution, it must return control 
to the routine dynamically previous to it. This is done by 
executing the RET extended instruction: 


RETurn from routine 

This instruction, which has 
frame section allocated to 
control to be returned to 
previous routine. The SFP 


RET RR 

no operands, causes the stack 
the routine to be freed up, and 
the interrupted point of the 
will be backed up so as to be 
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correct for the prior routine and registers 0 through 14 
restored from its savearea. If the returning routine desires 
to modify the registers cf the previous routine, an action 
which is entirely valid in certain cases, he may do so by 
picking up the previous pointer and using it as a base to 
address the previous registers. If the returning routine is 
re-entered, its automatic storage will have been in no way 
preserved. The contents of automatic storage are always 
undefined at the start of a routine. 


2 .5 TYPES OF RO UTIN ES 


At this point 
between various 
subroutines, and 


in time we can begin to 
types of routines, namely 
immediate routines. 


make a distinction 
parallel routines. 


2.5.1 PARALLEL ROUTINES f Ufk/) 


A parallel routine is one which can run simultaneously with 
and independently of any and all other routines. LEVELO 
has the capability to run an arbitrary number of parallel 
routines simultaneously within the system. Each parallel 
routine is given control and allowed to execute until some 
event occurs that LEVELO decides should cause another 
parallel routine to gain control. Each parallel routine has 
its own "infinite" stack frame which remains in existence 
until that routine returns. At the front of that stack 
frame is a section of storage known as the "stack frame 
header", which has the following format; 

1-T-1 

0 |parallel queue | 

l-1-1 

2 \ priorityl///////I 

4 |stack frame size| 

6 | SFP save 1 


parallel queue; this pointer is used by LEVELO to maintain 
a queue of the stack frames of each of the parallel 
routines currently running on the system. The nead of 
this queue is in memory location X’60'. 
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priority: This byte contains the priority assigned to this 

parallel event. The priority is used by LEVELO to 
decide which parallel event should be given control 
each time such a decision must be made. See Section 

3. 2. 

stack frame size: This halfword contains the stacx frame 
size estimation made by the programmer. See Section 
3.1. ! 

SPP save: Whenever the parallel routine is not executing, 
its current SFP is saved in this halfword. 

The previous pointer in the stack frame section of a 
parallel event is zero because there is no dynamically 
previous routine. Each parallel event is considered an 
entity in itself and control is never passed between them 
under programmer request. 

•.k-' 

Also associated with the entry into such a routine is some 
pre-determined data called '’status". This data is stored 
into the first bytes of the routine’s automatic storage 

by LEVELO before that routine is placed on the queue. The 
programmer must include this space in his automatic storage 
request in the ENT instruction. This data will be 
explained in greater detail later. (Jj ^ ^ 


2.5.2 SUBROUTINES 


A subroutine is a routine which is explicitly invoked by 
another routine. Although the subroutine is logically a 
separate routine with its own automatic storage, LEVELO 
considers it to be an extension of the invoking routine. 
It gets its stack frame section out of the stack frame of 
the invoking routine, and it runs with the priority of the 
originally entered parallel routine. 


The programmer exercises explicit control over the 
execution of subroutines; in order to invoke one he must, 
load the return address into register 14 and branch to the 
ENT instruction of the subroutine, via: 

DAL R 1 4, subroutine 


or, if the subroutine is external: 


LI Rx,V (subroutine) 

BALE R14,R x 
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When the subroutine is entered, the contents of the 
registers will be identical to what they were in the 
invoking routine, except of course for the SFP. It is not 
necessary for the subroutine to restore any registers 
before exiting with a RET instruction; this is taken care 
of by LEVKLO with the save areas. 

A subroutine itself may call other subroutines, down to any 
level. If a subroutine desires to modify the registers of 
the invoker, he may do so as explained in Section 2.3, by 
using the previous pointer as a base tor the invoker's 
stack frame section. A typical case of this is for 
implementing return codes. 


2.5.3 IMMEDIATE ROUTINES 


An immediate routine, unlike a parallel one, cannot run 
simultaneously with other routines. The purpose of the 
immediate routine is to perform system maintainence 
functions, such as the handling of I/O interrupts, as 
quickly and with as little overhead as possible. To 
accomplish this, a immediate routine must; 

1) Run disabled, i. e. , with the 1/0 and S/360 interrupt 
masks in the MSR off. This ensures that the execution of 
the routine will not be interrupted by any external unit. 

2) Not issue any extended instructions which would cause 
another parallel routine to gain control of the system. 
These restrictions will be described under the appropriate 
instructions. 

An immediate routine, however, may call subroutines and may 
cause other immediate routines to gain control. Any 
subroutine called must also follow the above conventions. 
An immediate routine and all its subroutines, because they 
do not run in parallel with other routines, do not have 
their own stack frame. Instead, they run in the stack 
frame of the parallel routine that was executing at the 
time the immediate routine was invoked. 
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2.5.4 REGISTERS AT ENTRY TO A ROUTINE 


The following table describes the status of the registers 

upon entry to a parallel or immediate routine: 

MSR: Condition Code and flag sero; Arithmetic Overflow 

and Stack Overfiow/Underflew disabled; interrupt 
masks as described above. Parity interrupts are always 
enabled, and the Parity interrupt mask hit in the MSP 
should not be altered. 

PC: Set appropriately. 

R2 - R 3: Identical to what they were when the formerly 
executing routine was interrupted. This is especially 
useful for SVC handling routines, which are passed 
parameters in these registers. 

R4 - R14: Undefined. 

SFP: Set appropriately. 
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3 EVENTS AND THEIB ROUTINES 


Now that the various types of routines available on LEVELO have 
been discussed, it is time to describe how individual routines 
are invoked. The simplest case is that of subroutines, which are 
explicitly invoked by the programmer as described in Section 
2.5.2. It is parallel and immediate routines that this section 
deals with. 


3 _EVENTS 


An event in BUGS is defined as the occurence of some sort of 
system interrupt that should delay the execution of the 
current routine and start up another. Events are such things 
as I/O interrupts, SVC calls. Program Checks, etc. LEVELO 
presumes that the LEV ELI system will have a routine which 
should be executed when each of these events occurs, and 
therefore must invoke the proper routine at the proper time. 
In order to do this, LEVELO needs an EVent List (EVL) , which 
is a list of entries, each one specifying an event and the 
routine to be invoked when it occurs. Each event entry has 
the following format: 


I-T-1 

0 I EVL link | 

l-1-1 

2 | event name | 

4 Ipriorityl flags | 

6 | routine entry | 

1-(• I 

8 |stack frame size| 

EVL link: This is the address of the next entry in the EVL. 

event name: This is the 16-bit name assigned to the event. 
Many events have names pre-assigned by LEVELO so that an 
effective communication with LEV EI.1 can ke set up. Other 
event names can be assigned by LEVEL1. The first hex 
digit of the name is called the event "type*', and is used 
in searching the EVL. 
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priority: This is the 8-bit priority assigned to the event 

routine if it is parallel. It is used in determining 
which parallel routine to run, as described below. 


flags: This byte contains flags describing the event routine: 

bit 0: If zero, this routine is immediate. If one, the 
routine is parallel. The priority is ignored for 
immediate routines. 


bit Is If on, the event is ignored when it occurs and 

no routine is invoiced. This bit may be altered 

dynamically by the LEVEL1 system. 

routine entry: This is the address of the routine itself. 

The first instruction must be an ENT specifying the 
amount of automatic storage desired by the programmer. 

stack frame size: This halfword is only used for parallel 
routines. As was mentioned previously, the stack frame is 
a logically infinite piece cf storage. In actuality, it 
is composed of one or more stack frame extensions. This 
halfword should contain an estimation of the total amount 
of stack frame space needed, so that the first extension 

will hopefully be the only one. This cuts down on LEVELO 

overhead and the fragmentation of memory. 


In order to locate the event entry for an event when it 
occurs, LEVELO uses a table of EVL '•heads 1 * 2 . There are 
sixteen halfword event heads, located in memory locations 70 
through 8E. Each head is used to point to the EVL for the 
corresponding event type. It is up to the LEVEL 1 system to 
set up the event head table in its initialization code. The 
sixteen event types are: 


TYPE DESCRIPTION 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 
A 


Interval Timer eveuts 
META 4 B events 
All other local I/O unit 
S/360 events 
) 


) 

) 

> events for LEV ELI use 
) 

) 

) 


events 


2 vide Section 8 for the location of these lists 







B ) 

C SVC events 

D Program Interrupt events 

E Program Manipulation events 

F Event trap 

The following steps are taken when an event occurs: 

1) LEVELO builds the appropriate event name and extracts the 
first hex digit as the event type. 

2) The event type is used to pick an EV1 head from the above 
table, and the EVL is searched for an entry containing the 
na me. 

3) If none is found, the fourth hey digit of the event name 
is zeroed and the list is searched again. This allows generic 
classes of events. 

4 and 5) If still no event entry is found, two more searches 
are made, with the third and second hex digits, respectively, 
also zeroed. 

6) Finally, if the above searches were unsuccessful, a check 
is made of event type F, the event trap, to see if any entry 
exists in that EVL, regardless of name. 

It is presumed that one of the above searches produces an 
event entry which can be used to invoke a routine. If no 
entry was produced, the event is ignored and discarded. If an 
entry was found, the following actions occur: 

parallel event: A new stack frame is created with the size 
specified in the entry. The header is initialized with 
the priority and the frame size and placed at the head of 
the gueue of stack frames. 

immediate event: The routine is entered after allocating it 

space in the current stack frame in accordance with its 
ENT instruction. 

No action is taken of course, if the igncre flag is on in the 
event entry. 
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3.2 DISPATCHING OF PAR ALLEL ROUTINES 


There are certain conditions under 
that the current parallel routine 
another one given control. Whenever 
"dispatcher" is executed. It perforins 


which LEVELO determines 
should be delayed and 
this occurs, the LEVELO 
the following search: 


1) A scan of the parallel queue is made for the highest 
priority runnable parallel routine. A routine is not runnable 
if it has gone into wait state (see Section 3.3.1). If two or 
more have the highest priority, the last one on the queue is 
picked. 


2) If all routines are in wait state, the first one is 
picked. 


Once a routine is picked, it is given control by loading its 
current SFP from the stack frame header and picking up its 
registers from the save area. During its execution the address 
of the predecessor stack frame header on the event queue will 
be in memory location X’62’. 


3.3 LEV E LI CONTROL OF ROUTINES AN E EVENTS 


Certain extended instructions are provided oy LEVELO to assist 
LEVEL1 in controlling the execution of routines and che 
occurence of events. 


3.3.1 WAIT AND POST 


It is possible for a routine to put itself into wait state, 
i.e. a state where execution is suspended, pending 
notification or "posting" by another routine. Wait state is 
controlled by the Wait Control Halfword (WCH) , used as the 
communication link between the waiter and the poster. 


WAIT on wch WAIT RX 

The second operand is a WCH, which is checked to see if bit 
0 is on. If not, the SFP of the routine issuing the WAIT is 
set into the WCH, and the routine is flagged as being in 
wait state by setting the Wait bit in its MSR. If bit 0 is 






on, the WCH has already been posted and the routine is 
allowed to continue. An immediate routine may not issue a 
WAIT. 


POST wch 


f>g>r rc ; w** 


PO ST 


FSS 


The second operand is a WCIi, which is posted by turning off 
the Wait bit in the MSB of the routine whose save area it 
points to. The first operand address is then moved into 
the WCH as a completion code and bit 0 is set on. 


A typical use for 
I/O operation to 
then WAITS on a 
handling routine. 


these instructions is for waiting for an 
complete. A routine starts some I/O and 
WCH which is POSTed by the I/O interrupt 


3.3.2 SIGNAL 


The SIGNAL extended instruction is provided to allow LEVEL1 
to force the invocation of an event routine. 


SIGNAL event 


SIGNAL 


FSS 


The second operand halfword is the name of an event whose 
occurence is to be forced. The event may be parallel or 
immediate and its routine will be invoked provided the EVL 
search is successful and the ignore bit is off. The first 
operand address points to the status to be placed in the 
beginning of the routine's automatic storage. This status 
must be in the following format: 


llength | 

I___L. 


status 


0 2 n 

An immediate routine cannot SIGNAL a parallel one, 





4 MAINTAINING CONTROLLED DATA 


A group of extended instruction are 
easily maintain controlled stor 
controlled storage are maintained 
Free Memory List (FML). The hea 
location X'64'. 


provided 

so 

that 

LEV EL 1 

can 

age. 

Co 

nt ig 

uous 

areas 

of 

in a 

linked 

list 

called 

t lie 

d of 

this 

list is 

; in me it 

lor y 


4.1 GETTING CCNT ROLLED STORAGE 


GET controlled storage Register GET1? RR 
GET controlled storage GET RX 

The contents of R2 (GETR) or the second operand halfword (GET) 
specifies the anount of controlled storage desired. This size 
is rounded up to a multiple of four bytes and the storage is 
obtained from the FML. Its address is returned in R1. If no 
contiguous piece of storage of the reguested size exists, a No 
Free Memory Program interrupt occurs. 


GET MAXimum controlled 


storage 


GETMAX RR 


The address of the largest contiguous piece of 
storage is returned in R1, and its length is 
If absolutely no storage is available, a 
Program interrupt occurs. 


free controlled 
returned in R2. 
No Free Memory 


4 j_2_FRjI12ING_C CNTRGLLE D_ST 0RjAGJ 


FREE controlled storage Register 
FREE controlled storage 


FREER RR 

FREE RX 


The contents of B1 contains the a 
controlled storage to be FREEd, i.e. 
The contents of R2 (FREER) or the 
(FREE) contains the length of this a 
not even an Invalid FREE Program interr 


ddress of an area of 
, put back on the FML. 
second operand halfword 
rea. If the address is 
upt will occur. 
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5 EXTEND ED I/O 


LEVELO provides a great many extended I/O facilities to the 
IE VE LI programmer, both in terms of local I/O and S/360 
communications. These facilities provide a higher level of 
control over I/O and I/O interrupts, allowing LEVELl routines to 
be much smaller and logically simpler. In addition, they 
eliminate all of the data codes associated with various units and 
reduce all data transfer to the EBCDIC code. 


5. 1 LOCA L I/O UNITS AN D THE CHANNEL 


5.1.1 THE CHANNEL PROG BAM 


LEVELO provides a logical "channel" which has the 
capability of executing multiple operations (IOCCs) at a 
unit via only one LEVELl instruction, EXCP, which initiates 
a chain of unit commands. These commands are known as 
Channel Program Commands (CPCs) and have the following 
format: 

Icommand |flags| address | length | 

i-1- j_j_j 

0 12 4 6 

command: This byte specifies the particular operation to 

be performed by this CPC at the unit. There are seven 
different commands: 

x 1 - Write. Data is transferred from the memory address 

specified to the unit. The length specifies the 
number of bytes to transfer. 

x2- Read. Data is read from the unit into memory at the 
address specified. The length determines the 
number of bytes read. 

x3- No Operation, No operation is performed at the unit. 
The address and length fields are ignored. 
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x4 - 


Sense. The USH is read into the halfword at the 
specified address. The length field is ignored. 


x5- Sense with Reset. This CPC operates exactly as Sense 
with the addition that any pending interrupt from 
the unit is reset. 

x6- Special. This CPC command has special usage with 
different units. See the explanation of each 
unit. 


x7- Transfer in Channel. 

I/C at the unit, 
that the channel 
different memory 


This CPC is not used to perform 
hut rather to cause a branch so 
program may be continued at a 
location. The address field 


specifies 
obtained; 


from where the 
the length field 


next CPC 
is ignored. 


is to be 


flags: The only flag currently used is 

checked after completion of each C 
in Channel, and, if on, another C 
the next three halfwords in memory 
Transfer in Channel, allows ini 
multiple operations at the unit w 
program. 


address: This fie 

data associated 
stored. 

length: This field 

commands. 


Id specifies the 
with the command 

gives a byte 


bit 0. This bit is 
PC except a Transfer 
PC is retrieved from 
. This feature, with 
tiating controllable 
ith only one channel 


nemcry address where 
is to be obtained or 


count for data transfer 


5.1.2 STARTING A CHANNEL PROGRAM 


SXecute 


Channel Program 


EXCP FSS 


The second operand address is the address of the first CPC 
in the channel program. This program is initiated, if 
possible, at the local unit specified by the low-ocder 4 
bits of the operand 1 a ddre ss. The Condition Code is set 
as follows: 


CO- Unit busy or offline. 

Cl- Channel program in progress. 

C2- Channel program completed immediately. 
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Once a channel program that caused Cl to be set is 
completed, an event with a pte-defined name is signalled by 
LEVELO. This is to inform LEVEL 1 of its completion and any 
error conditions that occured, and to allow LEVEL1 to 
perform any post-I/O housekeeping necessary. Appendix I 
lists these event names and their associated status 
informa tion. 


5.1.3 OTHER LOCAL I/O FACILITIES 


In order to control I/O interrupts, it is perfectly valid 
for LEVEL1 to manipulate the I/O mask bit in the HSR and 
the I/O unit mask in location 2E, within limits. It is 
considered invalid for a immediate routine to enable I/O 
interrupts. 

In addition, LEV5L1 can never modify the UCB table or the 
UCBs for any unit. However, the third halfword of each UCB 
is reserved for LEVEL1 use as a pointer to a UCB extension 
or whatever. LEVEL1 may access this halfword through the 
UCB table and modify it at will. 


5.1.4 HANDLING OF PARITY CHECKS 


When a Parity Check Control Panel interrupt occurs, LEVELO 
goes into "hard” stopped state. The user can only recover 
by resetting the system and re-IPLinq. 


5a. 2_S/360_COMM UNICATION 


Although S/360 I/O logically belongs on LEVELO, it is 
currently supported by a subroutine package which dynamically 
"hooks” itself into LEVELO. See S/360 - META 4A I/0 X 
Subroutine Descriptions for calling conventions. 




5.3 THE INTERVAL TIMER 


The Interval Timer decrements location X* 50 ’ every 100 usee. 
When location X’50' goes to zero, it causes an Interval Timer 
interrupt. The LEVELO support for the Interval timer allows 
the LEVEL1 user to keep track of running and CPO time, and to 
set time intervals. 


5.3.1 CPU AND RUNNING TIME 

The user may query the running and CPU time by use of the 
QTIMER instruction: 

Query TIM Eft QTIMER BX 

The first and only operand address is the address of an 
eight byte scannout acea, aligned on a halfword boundary. 
After completion of the QTIMEE instruction, the scannout 
area contains the running time and CPU time since the last 
I PL in tinier units (100 usee.): 


1 - 

1 

1 

Real 

Time 

1 

1 

1 

r 

i 

CPU 

time 

1 

1 

L 



j 


5. 3. 2 TIME INTER VALS 



The LEVEL 1 user may se t a time interval by placing the real 
time at which he wishes to be interrupted in the Timer Unit 
Control Block extension. When that time is reached, LEVELO 
will signal an interrupt to LEVEL1. 


5.4 META 4B COM MU NICATION S 


One instruction is provided by LEVELO for communications with 
the META 43. The META 4A can interrupt the META 4B and pass it 
a code using the INTB instruction: 

INTerrupt meta 4B INTB RX 
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The first and only operand address is passed to the rlETA 4B to 
identify the interrupt. 
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6 UNIT-DEPENDENT CPCS 


This section 
Write, Read 
EBCDIC, 


describes the CPCs which are unit-dependent, i, e. , 
and Special. Note that all data transfer is in 


6.1 3461 CARD READER 


0 1 - 


Write . 
e ncounte 
an Inval 
case for 


This command 
red, causes the 
id CPC Program 


is invalid fo 
channel progra 
interrupt to 


all invalid CPCs for every un 


r the 3461 and, 
m to be aborted 
occur. This is 
it. 


if 
a nd 
the 


02 - 


Read. This command causes 
by the length field to be 
the address in the CPC. 
range 1 to 80, unpredictable 


the number of bytes specified 
read into memory starting at 
If the length is not in the 
results will occur. 


06- Special. Invalid. 


TIMER 

01- Write. Invalid. 

02- Read. Invalid. 

16- Start Timer. The Timer begins to decrement location X' 50' 
every 100 microseconds. 

06- Stop Timer. 


6. 3 4132 K EY BO AS D /TXPE WRITER 


01 or 11- Write or Wr 
specified by the 
the Typewriter, 
carriage return 


ite withon 
address a 
with trai 
a p pe nd ed . 


t Edit. The character 
nd length fields is t 
ling blanks removed 
If an exact typing 


string 
yped on 
a nd a 
of the 
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string is desired, with trailing blanks and no carriage 
return, then bit 3 of the command should be set. 

02 or 12- Read or Read without Edit. Input is accepted from 
the keyboard until either a carriage return is typed or 
the length is exhausted. If a Read is performed, as 
opposed to a Read without Edit, then two extra facilities 
are provided: Loqical Backspace and Logical Line Delete. 
If a logical backspace character is typed (LEV ELI 
specifies this character in location 66), the previous 
character is ignored and removed from the input buffer. 
If a logical line delete is typed (also specified by 
LEVEL1 in location 67), the complete preceeding input is 
ignored and the Read is restarted. 

06- Special. Invalid. 


6.4 1444 DISK STORAGE U NI T 


xl- 


W ri te. 


Data is written onto the disk from the buffer 


pointed to by the CPC address. This buffer has the 
following format: 


re ser ved 
- h- 


0 I 

-1 

2 | sector address | 

I-+-1 

4 | DATA | 

p-1-1 


The length is rounded up to a halfword and used to 
determine the amount of data to write. Airy amount may be 
written with one CPC. The sector address specifies the 
first sector on which data is to be written; an 
automatic seek to this sector is performed by LEVELO. If 
the length is not a multiple of 64 0 bytes, the last 
sector will be filled with zeroes. 

02 or 12- Read or Read Check. The Read command uses the same 
buffer format as a Write, and performs equivalently in 
terms of length specification, automatic seek, etc. The 
only difference is that data is read into the buffer and 
the length does specify the exact amount of data to 
transfer. 
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Read Check is used to check data just written on 
should be chained onto every Write for best 
The address and length fields should be 
those in the Write. 


the disk and 
performance, 
identical to 


06- Special. This CPC is used to cause a "stand-alone" seek 
of the carriage arm. This can cause a performance 
increase in certain situations where computing is to be 
done before a Read or Write - the seek can operate 
concurrently with the computing. The address field 
points to a halfword containing the sector address to 
which the seek is done; the length field is ignored. 


6.5 CONTROL P ANEL 


x 1 - Write. Either one or two halfwords at the address 

specified are written on the lights, depending on the 
setting of bits 2 and 3: 

00; No Operation. 

01: One halfword is written on the lowers. 

10: One halfword is written on the uppers. 

11: First halfword is written on the uppers and 

the next one on the lowers. The length field is 

ignored. 

x2- Read. The contents of the data switches are read into 
the halfword at the specified address; the length field is 

ignored. 

x6- Special. Invalid. 


r 6.6 NULL ilETA 4B 


0 1- PIO Write. The halfword at the data address is used to 
perform a PIO write to the Vector General. The length 
field is ignored. 

0 2- Read. The length field divided by two specifies the 
number of consecutive registers to be read from the 
Vector General into the memory location specified. The 
starting register address is determined by the last PIO 
Write CPC. 
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06 or 16- Allow Interrupts or Set Display Buffer Address. 
The Allow Interrupts command is used to inform the META 
43 that it can again request interrupts. This CPC should 
be issued at the end of the interrupt handler for the 3. 

In a Set Display Buffer Address Command, the display 
buffer address specified in the CPC is sent to the Null 
META 4B so that it can initialize tor displaying. 


Both of these CPCs ignore the length 


field. 




7 APPENDIX I: LEVBLO-DEFIN ED EVENTS 


This section lists and describes the events that ace pre-defined 
by LEVELO. In addition, the status data passed to the event 
handling routine in its automatic storage is explained. 

The first halfword of the status, and therefore of an event's 
automatic storage, is always the event name that was originally 
signalled (as opposed to the name actually found in the EVL 
search). This is also true for events caused by LEVEL1 via the 
SIGNAL instruction. The remaining status is variable, although 
two halfwords are common: 

Last CPC Address: On an I/O event, this is the address of the 
last CPC that was interpreted. Some CPCs may be ignored if 
an error condition arises. 

USH: On an 1/0 event, this is the final USH from the unit 

causing the event. 


7 A J_INTER V AL_TIM EB_E V EN 25 


2001- The time of day placed in the UCB extention by LEVEL1 
has been reached. Status is the running time {32 bits) 
and CPU time (J2 bits) at the time of the interrupt, in 
timer units. 


Za2_META_4D_E VENTS 

1031- META 4B interrupt. Status is the cede specified in an 
INTA instruction executed on the META 4D. 


7.3 NULL META 4E EVENTS 


1031- Null 
display 
enabled 


META 4B interrupt. Status is the USH and the 
buffer address. Further interrupts will be 
after an Allow Interrupts CPC is executed. 
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7.4 OTHER IOCA1 I/O U NIT EVEN TS 

The second hex digit of the event name for these events is the 
unit address of the local I/O unit. 


7.4.1 3461 CARD READER 


2411- Channel Program Complete. Status is Last CPC 
Address and USH. 

2421- I/O Error, caused by Read or feed Check, or Hopper 
Empty. Status is the same as 2411. 


7.4.2 4132 KEYBOARD/TY PEWHITER 


2611- 


Channel Program Complete. 
Address, USH, and Remaining 
Length is only meaningful on 
gives the difference between 
the CFC and the actual number o 


Status is Last CPC 
Length. The Remaining 
Read commands, where it 
the length specified in 
f characters typed in. 


2631- Interrupt Switch. Status is USH. 


7.4.3 1444 DISK STORAGE UNIT 


2211- Channel Program Complete. Status is Last CPC 
Address and USH. 

2221- Seek Check, caused if the sector number on an 
automatic or stand-alone seek cannot fce verified after 
ten retries. Status same as 2211. 

2222- 1/0 Error, caused by Read or Read Check commands if 
a data transfer error persists after 10 retries. 
Status is same as 2211 and 2221. 
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7.4.4 CONTROL PANEL 


2 531- Interrupt Button, 
event name. 


There is no status other than the 


7.5 SVC EVENTS 


The event name for an SVC instruction is always COxx, where xx 
is the SVC code. No status other than the name itself is 
passed. 


7. b PROGRAM INTERRUPT EVENTS 


The event name for a Program 
xx is the Program interrupt 
name itself is passed, except 


Interrupt is always DOxx, where 
code. No status other than the 
in the following cases; 


Operation- An image of the Program Interrupt Scan-out Area is 
passed, comprising five halfwords of status. 

Invalid CPC- The Last CPC Address is passed. This CPC 
contains the invalid command. 


7 I _7_PROGRAM_HjyiIPULATION_E VENTS 


This event is really LEVEL 1-defined, 
in initially starting up the 
multi-prog ramming maintenance. See 
manual for an explanation. 


but is intended for use 
IEVEI.1 system and in 
the appropriate LEVEL 1 


7.8 EVENT TRAP 


As described in 
event entry was 
the event trap 
name of F000. 


Section 
found in 
EVL is 


3.1, this event is used if 
the EVL search. The first 
used, and should have a 


no other 
entry in 
standard 
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8 APPENDIX II: LEVELO LCWEB MEMORY LAYOUT 


The following table lists the various lower memory areas in 
LEVELO which ace accessable by LEVEL1: 


location contents 

2E I/O unit interrupt mask 

30 UC3 Table - Interval Timer UCB address 

32 META 4B UCB address 

34 1444 Disk Storage Unit UCB address 

36 

38 3461 Card Reader UCB address 

3A Control Panel UCB address 

3C 4132 Keyboard/Typewriter UCB address 

3 E META 4 A UCB address 

40 SIMALE UCB address 

42 Vector General UCE address 

44 

46 S/360 Device 050 UCB address 

48 S/360 Device 051 UCB address 

4A S/360 Device 052 UCB address 

4C S/360 Device 053 UCB address 

4 E 

50 Interval Timer 

60 Parallel Queue head 

62 Pointer to predecessor of executing routine 

64 Free Memory List head 

66 Logical Backspace character 

6 7 Logical Line Delete Character 

70 Event List heads - Timer events 

72 META 4B events 

74 all other local I/O unit events 

76 5/360 events 

78 ) 

7 A ) 

7 C ) 

7E > events for LEVEL1 use 

80 ) 

82 ) 

84 ) 

86 ) 

88 SVC events 
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8A Program Interrupt events 

8C Program Manipulation events 

BE Event trap 










9 APPENDIX III: LEVE L 1 PR OGRAM INTERRUPTS 

The following table lists the Program interrupt codes that can 


occ ur 

on LEV ELI: 

CODE ] 

DESCRIPTION 

2 

Ope ration 

B 

Arithmetic Overflow 

A 

Conversion Overflow 

C 

Division by Zero 

E 

Alignmen t 

1 0 

Register Specification 

12 

Privilege 

14 

Stack Overflow 

16 

Stack Underflow ' 

18 

Execut e 

20 

No Free Memory 

22 

Invalid FREE instruction 

24 

Invalid CPC 

26 

Zero S/360 UCD Address 
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10 APPENDIX IV: EXTEN DED INSTRUCTION OP CODES 

The following table lists the operation codes for the LEVELO 
extended instructions: 


INSTRUCTION 

CODE 

^ ENT 

EE 

v/ EX CP 

FD 

/FREE 

43 

FREER 

03 

^GET 

41 

/ GETMAX 

02 

/'GETR 

01 

v I NTB 

6 F 

/'POST 

FE 

^/QTISll ER 

64 

(/RET 

OB 

</ SIG NAL 

FC 

1 / WAIT 

7 E 

WR ITE 

67 f 
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11 APPENDIX V: 114 A LIB MACROS 


Certain macros are provided for 
programmer. These macros reside 
(M4ALIB) and are described in the £o 


the LEVEL 1 assembly 
in the BUGS macro 
llowing paragraphs. 


language 
libr ar y 


11.1 EVENT 


This macro generates an Event entry which can be placed on an 
EVL. It is coded as follows: 

[label] EVENT link,name,flags,entry-point 

[,priority,stack-frame-size] 

The priority and stack frame size need only be coded for 
parallel routines. 


11.2 AUTO/ END AUTO 


These two 

mac ros 

are used in 

describing the 
coding: 

stack frame 

label 

AUTO 


which generates: 

LINE 

* 


* 

* 

LINE 

AUTOMATIC 

label 

DSECT 



USING 

label,SFP 

label P 

DS 

A 

labelN 

DS 

A 

labelR 

DS 

15H 

la b e 1A 

DS 

OC 


ach routine to generate a DS ECT 
ection. The DSECT is begun by 


OR AGE MAP 


PREVIOUS POINTER 
NEXT POINTER 
REGISTER SAVE 
AUTOMATIC STORAGE 
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Following the AUTO, DS's for the automatic variables can be 
coded. Once all the automatic space is defined, the programmer 
should code: 

EN DA UTO 

which will generate: 

label L EQU *-labelA AUTO STORAGE LENGTH 

RSYSECT CSECT 
LINE 

to end the DSECT. The symbol "iabelL" should be used in the 
ENT instruction to specify the length of the automatic storage 
desired. Do not forget to include space for status data. 


11.3 RETCODE 


This macro is used in a subroutine to return a code in one of 
the registers of the invoking routine. It is coded: 

[label] RETCODE inv cker-reg[ , code | (reg) ] 

The return code specified in the macro or contained in the 
(reg) register is placed in the register of the invoking 
routine specified by " invoker- reg" . Register 2 is bashed in 
the process. 


11. 4 CPC 


This macro is used to generate a CPC for use with the EXCP 
instruction. 

[label] CPC command ,flags[ ,address[ , length ] ] 

If the address and/or length is not coded, these fields are 
set to zero in the generated CPC. 
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11.5 IEVE10 


This macro 
locations in 
the macro is 


generates an equate table of the LEVEL0-defined 
lower memory accessable by LEVEL1. A listing of 
available for those who need it. 
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